7

Anhänge

Dieser Abschnitt gibt eine Kurzübersicht über die XML-Funktionen und Ñ-Konventionen.

Ein XML-Dokuments setzt sich in dieser Reihenfolge aus den folgenden Bestandteilen zusammen:

• Einer XML-Definition (optional, jedoch dringend empfohlen)
• Einer DOCTYPE-Definition und einer DTD (optional), einschließlich Kommentare, Verarbeitungsanweisungen und Entitätsverweise.
• XML-Elementen (und ihrer Attribute), Kommentaren, Verarbeitungsanweisungen und Entitätsverweisen.

Die XML-Definition, falls enthalten, ist stets die erste Zeile in einem XML-Dokument. Sie gibt neben der XML-Version des Dokuments an, ob die Datei Verweise auf andere Dateien enthält. Beispiel:

Die DOCTYPE-Definition ­ die die DTD des Dokuments definiert ­ wird stets hinter die XML-Definition und vor den Anfangstag des Stammelements gesetzt. Die DTD setzt sich aus zwei Hauptbestandteilen zusammen: einer externen und einer internen Untergruppe. Wenn das Dokument nur über die externe Untergruppe verfügt, sieht es so aus:

Wenn das Dokument nur über eine interne Untergruppe verfügt, sieht es so aus:

Wenn das Dokument über eine externe und interne Untergruppe verfügt, sieht es so aus:

Ein Element besteht aus einem Anfangstag (<TagName>), dem Inhalt und einem Endtag (</TagName>):

Eine Ausnahme ist das leere Tag, bei dem es sich um ein einzelnes Tag mit einem Schrägstrich vor der schließenden spitzen Klammer > handelt:

Alle Elemente müssen ordnungsgemäß verschachtelt sein, d. h. das zuletzt geöffnete Tag muss geschlossen werden, bevor andere Tags geöffnet werden können. Die folgenden Zeile wäre beispielsweise in einem XML-Dokument ungültig, da <Tag2> nicht vor <Tag1> geschlossen wird:

Jedes XML-Dokument muss über ein Stammelement verfügen, dass alle anderen Elemente des Dokuments enthält.

Bei den Elementnamen wird zwischen Groß- und Kleinschreibung unterschieden. Jedes Element muss mit einem Buchstaben oder einem Unterstrich (_) beginnen. Bei den darauf folgenden Zeichen kann es sich um Buchstaben, Unterstriche, Zahlen, Bindestriche und Punkte, nicht jedoch um Leerstellen oder Tabulatorzeichen handeln.

Elemente können Attribute als Bestandteil des Anfangstags (oder, bei leeren Elementen, als Bestandteil des einzelnen Anfangs-/Endtag) enthalten. Ein Attribut besteht aus einem Namen, auf den ein Gleichheitszeichen und dann ein Attributwert in Anführungszeichen folgt. Beispiel:

Ein Kommentar ist Text zwischen den Zeichen <!-- und -->. XML-Prozessoren sollten den Inhalt von Kommentaren ignorieren. Kommentare dürfen kein "--" oder andere Kommentare enthalten.

Eine Verarbeitungsanweisung ist Text zwischen den Zeichen <? und ?>. Verarbeitungsanweisungen werden ausschließlich von XML-Prozessoren gelesen und dürfen keinen Inhalt enthalten. Die Syntax für Verarbeitungsanweisungen sieht so aus:

Ein Zeichenverweis ist die Darstellung eines Unicode-Zeichens mit Hilfe von analysierten Zeichendaten. Die Syntax für Zeichenverweise sieht so aus:

Entitätsverweise sind Namen, die bestimmte Zeichen, Textketten oder Dateien darstellen. Entitätsverweise in einem XML-Dokument werden stets zwischen ein Ampersand (&) und ein Semikolon (;) gesetzt. Beispiel: &gt; steht für das "Größer als"-Zeichen (<), das im XML-Inhalt ausschließlich als Entitätsverweis enthalten sein darf.

Die Bedeutung jedes in einem XML-Dokument verwendeten Entitätsverweises muss in der DTD des Dokuments definiert werden. Ausgenommen sind die folgenden, vordefinierten Zeichenentitätsverweise, die ohne Definition verwendet werden können:

Wohlgeformte XML-Dokumente müssen die folgenden Regeln erfüllen:

• Die erste Zeile sollte eine XML-Definition sein.
• Für jedes Anfangstag muss ein Endtag vorhanden sein (ausgenommen sind einzelne leere Tags).
• Einzelne leere Tags müssen auf /> enden.
• Es muss ein Stammelement vorhanden sein, das alle anderen Elemente enthält.
• Alle Elemente müssen ordnungsgemäß verschachtelt sein, d. h. das zuletzt geöffnete Tag muss geschlossen werden, bevor andere Tags geöffnet werden können.
• Alle Attributwerte müssen in Anführungszeichen gesetzt sein("").
• Alle Tags müssen mit < und alle Entitäten mit & beginnen.
• Es dürfen nur die oben aufgelisteten, vordefinierten Entitätsverweise verwendet werden ­ es sei denn, das Dokument verfügt über eine DTD.

Ein gültiges XML-Dokument ist ein wohlgeformtes XML-Dokument, d. h. es entspricht der DTD, die in seiner DOCTYPE-Definition festgelegt wird.

Dieser Abschnitt gibt eine Kurzübersicht über die DTD-Funktionen und Ñ-Konventionen.

Eine DTD kann sich aus den folgenden Bestandteilen zusammensetzen. Eine bestimmte Reihenfolge ist nicht erforderlich:

• Elementtypendefinitionen
• Attributdefinitionen
• Kommentare
• Entitätsverweisdefinitionen
• Notationsdefinitionen
• Verarbeitungsanweisungen
• Analysierte Entitätsverweise
• Abschnitte mit Konditionalaussagen

Die Syntax einer Elementypendefinition sieht so aus:

Bei den Elementnamen wird zwischen Groß- und Kleinschreibung unterschieden. Jedes Element muss mit einem Buchstaben oder einem Unterstrich (_) beginnen. Bei den darauf folgenden Zeichen kann es sich um Buchstaben, Unterstriche, Zahlen, Bindestriche und Punkte, jedoch nicht um Leerstellen oder Tabulatorzeichen handeln.

Der Elementinhalt kann aus analysierten Zeichendaten (d. h. Text- und Entitätsverweise, die als ausgedrückt werden) und/oder Elementtypen bestehen. Die folgenden Symbole können hinter dem Namen eines Elements oder der Abschlussklammer in der Elementinhaltsdefinition eingefügt werden:

Setzen Sie ein Komma, wenn ein Element auf ein anderes folgen soll:

Setzen Sie ein "|", um anzugeben, dass der Inhalt ein bestimmtes Element oder ein anderes Element enthalten kann:

Verwenden Sie die folgende Syntax, wenn das Element eine Kombination aus bestimmten Elementen und #PCDATA in beliebiger Reihenfolge enthalten soll:

Verwenden Sie die folgende Syntax, wenn das Element eine Kombination aus Elementen und #PCDATA in beliebiger Reihenfolge enthalten soll (Beachten Sie das Weglassen der Klammer):

Verwenden Sie die folgende Syntax für die Definition eines leeren Elements (Beachten Sie das Weglassen der Klammer):

Die Syntax für die Definition eines einzelnen Attributs sieht so aus:

Bei den Attributnamen wird zwischen Groß- und Kleinschreibung unterschieden. Jedes Attribut muss mit einem Buchstaben oder einem Unterstrich (_) beginnen. Bei den darauf folgenden Zeichen kann es sich um Buchstaben, Unterstriche, Zahlen, Bindestriche und Punkte, jedoch nicht um Leerstellen oder Tabulatorzeichen handeln.

Attributarten können wie folgt aussehen:

*Namen müssen mit einem Buchstaben oder einem Unterstrich (_) beginnen. Bei den darauf folgenden Zeichen kann es sich um Buchstaben, Unterstriche, Zahlen, Bindestriche und Punkte, jedoch nicht um Leerstellen oder Tabulatorzeichen handeln.

**NameZeich-Zeichen enthalten Buchstaben, Unterstriche, Zahlen, Bindestriche oder Punkte, jedoch keine Leerstellen oder Tabulatorzeichen.

Standard-Attributwerte können so aussehen:

Ein Kommentar ist Text zwischen den Zeichen <!-- und -->. XML-Prozessoren sollten den Inhalt von Kommentaren ignorieren. Kommentare dürfen kein "--" oder andere Kommentare enthalten

Ein Zeichenverweis ist die Darstellung eines Unicode-Zeichens mit Hilfe von analysierten Zeichendaten. Die Syntax für Zeichenverweise sieht so aus:

Es gibt fünf Entitätstypen mit der folgenden Syntax:

Die Syntax für die Verwendung der ersten drei Entitätstypenverweise lautet &EntitätsName;. Die Syntax für die Verwendung einer Parameter-Entität lautet %EntitätsName;. Parameter-Entitätsverweise sind stets analysiert und dürfen nur in DTDs verwendet werden.

Notationsdefinitionen sollten wie folgt verfasst werden:

Die externe Kennung sollte der Name einer Anwendung sein, die die Dateien verarbeiten bzw. anzeigen kann, auf die diese Notation angewendet wird. Beispiel:

Beachten Sie, dass es von der Anwendung, die die XML verarbeitet, abhängt, ob der URL an die von der externen Kennung angegebene Anwendung weitergeleitet wird.

Eine Verarbeitungsanweisung ist Text zwischen den Zeichen <? und ?>. Verarbeitungsanweisungen werden ausschließlich von XML-Prozessoren gelesen und dürfen keinen Inhalt enthalten. Die Syntax für Verarbeitungsanweisungen sieht so aus:

Nehmen wir einmal an, Sie haben gerade eine XML-Datei aus avenue.quark exportiert. Wenn Sie sich die Datei in Ihrem Textbearbeitungsprogramm ansehen, stellen Sie fest, dass ein kleingeschriebenes "a" mit einem Akzent überall dort angezeigt wird, wo eigentlich das Warenzeichensymbol stehen sollte. Und das ist nicht das einzige Zeichen, das falsch abgebildet wird, eine ganze Reihe von Sonderzeichen sehen irgendwie falsch aus. Was ist passiert?.

Sehr wahrscheinlich wird die Verschlüsselung der XML-Datei von Ihrem Textbearbeitungsprogramm nicht unterstützt. Dieser Sachverhalt wird in diesem Abschnitt detailliert erklärt.

Eine Verschlüsselung ist eine Spezifikation, die eine Gruppe von Zeichen bestimmten numerischen Werten auf dem Bildschirm zuordnet. Beispielsweise ordnet der ASCII-Code das Zeichen "M" dem numerischen Wert 77, das Zeichen "N" dem numerischen Wert 78, das Zeichen "O" den numerischen Wert 79 usw. zu.

Die Verschlüsselung einer Textdatei ermöglicht es der Anwendung, die Textdatei in die richtigen Zeichen auf dem Bildschirm zu übersetzen. Ohne Verschlüsselung bestände eine Textdatei lediglich aus Ansammlung von Zahlen. Wenn Sie eine Textdatei mit der falschen Verschlüsselung anzeigen, werden die Zeichen nicht richtig abgebildet, da die Anwendung beim Öffnen der Datei die numerischen Wert der falschen Zeichengruppe zuordnet.

Im Folgenden sind einige Verschlüsselungen aufgelistet:

• ASCII
• MacRoman (für Mac OS)
• Windows Latin 1 (für Windows)
• UTF-8
• UTF-16 (Unicode)
• Shift-JIS

Avenue.quark unterstützt die Verschlüsselungen UTF-8, UTF-16 und Shift-JIS.

Die meisten Verschlüsselungen lassen sich wie folgt aufteilen: die ersten 128 Zeichen (der untere Bereich) und alle darauf folgenden Zeichen (der obere Bereich).

Der untere Bereich der meisten Verschlüsselungen wird denselben Zeichen zugeordnet. Dieser Bereich enthält die Zeichen a-z, A-Z, 0-9, einige Interpunktionszeichen und einige spezielle Steuerzeichen.

Probleme treten meist mit den Zeichen des oberen Bereichs auf. Beispiel: Die unteren Bereiche der Schriften MacRoman und Windows Latin1 sind nahezu identisch. Wenn Sie also eine Datei, die nur Zeichen aus diesem Bereich verwendet, von Mac OS auf Windows übertragen, sollten keine Probleme auftreten. Wenn die Datei jedoch Zeichen aus dem oberen Bereich enthält, dann werden die Werte dieser Zeichen u.U. nicht den richtigen Zeichen auf der jeweiligen Plattform zugeordnet. Ein Zeichen, das beispielsweise unter Mac OS als Warenzeichensymbol angezeigt wird, wird unter Windows möglicherweise als hochgestelltes kleingeschriebenes "a" abgebildet.

Wenn die Zeichen nicht richtig abgebildet werden, kann dies zwei Ursachen haben. Entweder wird die Verschlüsselung des Textes von der Anwendung, in der er angezeigt wird, nicht erkannt, oder die Anwendung kann den Text mit der für die Datei festgelegten Verschlüsselung nicht ordnungsgemäß anzeigen

Geben Sie die Verschlüsselung einer XML-Datei durch Einschließen der Verschlüsselungsspezifikation in der XML-Definition der Datei wie folgt an:

Wenn die XML-Datei keine Verschlüsselungsspezifikation enthält, nimmt avenue.quark an, dass die Verschlüsselung UTF-8 verwendet wird.

Beim Sichern einer XML-Datei in avenue.quark geben Sie die Verschlüsselung des Dokuments im Popup-Menü Verschlüsselung an. Das zugehörige Verschlüsselungsattribut wird dann automatisch von avenue.quark generiert.

Mit XML können Sie die Verschlüsselung für eine XML-Datei, nicht jedoch für eine freistehende DTD-Datei festlegen.

Dies ist zum Glück mit avenue.quark möglich. Fügen Sie den folgenden Text als erste Zeile der Datei wie folgt hinzu, um die Verschlüsselung für eine freistehende DTD-Datei festzulegen:

Wenn Sie beispielsweise eine freistehende DTD als UTF-16 DTD festlegen möchten, setzen Sie einfach die folgende Zeile an den Dateianfang: